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Introduction 



Welcome to the ReRUN Fail 
Edition. In this edition, we give 
you a wide variety of programs, 
many of wtiicfi appeared in 
RUN'S June, July and August 
issues. Three have never before 
been published. All programs w/ill 
work on the C-64 and on the 
C-128 (in C-64 mode). Directory 
titles are capitalized below and 
are usually not the same as the 
article titles. You must, of course, 
use the directory titles when 
loading programs. 

This edition of ReRUN offers 
you three powerful disk-utility pro- 
grams. AUTO fylENU simplifies 
disk usage by loading and run- 
ning programs with just a single 
keystroke. This program appears 
first on your disk, and when it's 
run, it will display the entire 
ReRUN disk directory. From 
there, you simply press the letter 
corresponding to the program 
that you want to run. 

Call the Doctor (DISK DOC- 
TOR) offers you a remedy for just 
about all of your disk problems. 
It IS a valuable tool for regular 
disk checkups and includes op- 
tions to list a directory, restore a 
file, pack a directory, list used 
blocks, view or modify blocks, 
format a disk and send a disk 
command. 



The third disk utility is 64 Disk 
Directory (64 DIRECTORY). This 
will be one of your most-used 
programs, whether you are a 
programmer or strictly an appli- 
cations user. Just load and run 
64 DIRECTORY. Whether or not 
you're in the middle of a running 
program, you can see a direc- 
tory of any disk in your drive with 
just the press of a function key. 

We have two programmer's 
aids for you. Byte-Size Compiler 
{MICRO COfvlPILER) is a disk- 
based Basic compiler that will 
convert a Basic program into 
machine language. It is easy to 
use and allows you to take ad- 
vantage of the speed of machine 
language programs. To accom- 
pany this compiler, we are pro- 
viding TEST COfvlPILER and 
COLORS DEMO for your use in 
testing the compiler. 

A Dozen Will Do It (FUNCTION 
KEYS) offers programmers a way 
to gam access to ^^ function 
keys instead of etght. It prepro- 
grams the function keys to set 
background, border and char- 
acter colors, to list a program 
and to run a program. I will also 
load a disk directoiy if the C-64 
Wedge is in place. 

A Dozen Will Do It also offers 



you CALCULATOR, a program 
demonstrating the various meth- 
ods of accessing preprogram- 
med function keys. It also acts 
as a valuable personal calculator, 
C-64 Big Letters gives you 
three separate application pro- 
grams for designing colorful 
screens full of large characters. 
BIG LETTERS is an editing pro- 
gram that lets you design your 
own big-letter screen directly 
from your keyboard. TITLE MA- 
KER is a videotape title-making 
program that allows you to enter 
your titles as ASCII numbers 
within data statements, thus mak- 
ing it easy to save and reuse 
your designs. Finally. BANNER 
MAKER lets you type in a self- 



repeating big-letter banner 
across the middle of your screen. 

High Performance Turtle (TUR- 
TLE GRAPHICS) adds ten new 
commands to your computer 
for using high-resolution turtle 
graphics. It is a Basic loader that 
installs the following graphics 
commands: Reset, Hires, Text, 
Coir, Left, Right, Move, Tailup, Tail- 
down and Plot. TURTLE DEMO 
is an accompanying demonstra- 
tion program that illustrates some 
of the amazing graphics designs 
you can achieve using these 
commands. 

We haven't forgotten educa- 
tion. TEST MAKER lets you cre- 
ate, modify and save files of test 
questions and answers. Once a 



question file has been created, 
TEST TAKER will load your test- 
question file and give you the 
option of either testing your stu- 
dents or drilling them with ran- 
dom setections from the test file. 

Lastly, we have two brand-new 
games. HOME RUN DERBY 
places you at a night game 
with baseball fans jamming the 
stands. You can hit and pitch, 
with the goal of hitting as many 
home runs as possible. 

In GOLD GRABBER, you con- 
trol a daring adventurer, Flynn, 
in hts quest to catch bags of gold 
and hide them in his hilltop re- 
treat. Watch out for the hungry 
eagle and falling ten-ton weights. 

There you have it for another 



action-packed edition of ReRUN, 
We are looking forward to bring- 
ing you the PRODUCTIVITY PAK 
later this fall. It will be our second 
ReRUN Special Edition, and will 
be filled with productive appli- 
cations for your C-64 and C-128 
(in C-64 mode). We also have 
great plans for the ReRUN Win- 
ter Edition, which will contain the 
best programs from RUN's Sep- 
tember, October and November 
Issues. 



MARGARET MORABITO 
Technical Manager 
RUN Magazine 



How to Load 



DISK: 

To load any of the programs, type: 

LOAD "program name", 8 

ttien press the RETURN key. 

The disk dhve should whir while the screen prints SEARCHING FOR (program 
name). The screen should then print LOADING and then finally READY, with 
the flashing cursor beneath, Type RUN and press the RETURN key. The 
program will then begin. 

CASSETTE: 

Insert the cassette tape into the Datassette recorder, with the proper side facing 

up. fvlake sure that the tape is rewound all the way to the beginning. Type: 

LOAD "program name" 

then press the RETURN key. The screen will display PRESS PLAY ON TAPE. 
You should then push the play button on your Datassette recorder. 

When the program has been found, the screen will display FOUND (program 
name). On some Commodore computers, you may then have to press the 
C= (Commodore symbol) key to load the program. On other Commodore 
machines, the program will load automatically. Check your owner's riianual 
for specific loading procedures. 

When the program has finished loading, you will see the READY prompt 
and the flashing cursor beneath. Type RUN and press the RETURN key to 
start the program. 

NOTES: 

You should use the entire program name exactly as listed to avoid loading 

programs that have similar titles. 

Before loading a program, always refer to the article in the booklet for special 

instructions. 

Be sure your C-12a is in C-64 mode before attempting to load these programs. 
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Directory 



DISK 



/ 



CASSETTE 

13 BIG LETTERS 

13 TITLE MAKER 

13 BANNER MAKER 

16 TURTLE GRAPHICS* 

16 TURTLE DEMO 

20 CALCULATOR 

20 FUNCTION KEYS 

23 TEST MAKER+ 

23 TEST TAKER 

28 HOME RUN DERBY 

31 GOLD GRABBER 



1 AUTO MENU" 
4 DISK DOCTOR "^ 

11 64 DIRECTORY :.- 

13 BIG LETTERS^ / 

13 TITLE MAKER ' 

13 BANNER MAKER 

16 TURTLE GRAPHICS 

16 TURTLE DEMO 

20 CALCULATOR 

20 FUNCTION KEYS 

23 TEST MAKER+ 

23 TEST TAKER 

28 HOME RUN DERBY 

31 GOLD GRABBER 
•33 MICRO COMPILER 
•33 TEST COMPILER 
•33 COLORS DEMO 

* You must load and run TURTLE GRAPHICS before 

you can load and run TURTLE DEMO. 
+ You must create a questions file using TEST MAKER 

before you can use TEST TAKER. 

Read the Introduction before trying to load any 

programs. 



Auto Menu 

Simplify disk operations by loading programs 
with a single keystroke. 

By Joe W. Rocke 



RUN It Right 



CM: cm (in CM mode) 
Disk drivf 



Auto Menu is a disk-based util- 
ity that takes the hassle out of 
loading a program. The Load 
and Run commands become a 
menu-driven operation. With a 
single keystroke, you select the 
program to be loaded. Your C-64 
then takes over, automatically 
loading and running the selec- 
tion. Even the most inexperi- 
enced newcomer can load a 
program. 

The C-64 wedge and similar 
utilities provide shortcuts in typ- 
ing the Load command. How- 
ever, it's still up to you to re- 
member and correctly type the 
program name. Everyone who 
uses a disk system has been 
confronted with a File Not Found 
message because of a typing er- 
ror. Most of us have to load and 



read the disk directory unless a 
crib sheet of program names is 
handy. 

SIMPLIFIED OPERATION 

Auto Menu lists the disk direc- 
tory in menu format, The disk 
directory is read automatically 
and listed in double-column 
form, which prevents all but the 
longest listing from scrolling off 
the screen. 

Each filename is preceded by 
a letter that is assigned by Auto 
Menu. The letter serves as an 
identifier for program selection, 
and filenames are listed in the 
order the programs are stored 
on the disk. To load a program, 
press its filename's correspond- 
ing letter. This will also clear the 
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TEST MAKER 2 
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screen and display a loading 
message. A typical message dis- 
play is as follows: 

LOAD "PROGRAM NAM*", 8,1 
SEARCHING FOR PROGRAM 
NAM* 
LOADING 

No further keyboard input is 
necessary after the initial menu 
selection. Thie loading operation 
takes place automatically, and, 
upon its completion, the com- 



puter automatically initiates a 
Run command. Finally, the menu 
program is removed from mem- 
ory with a New command. 

To facilitate the auto-run op- 
eration, the asterisk (*) pattern- 
matching format is used in Auto 
Menu's loading instruction, as 
descnbed in the 1541 user's 
guide. Pattern matching simply 
means that the drive will load the 
first program that has a name 
matching the letters in the Load 
instruction. In this program, the 




first 12 letters of program names 
are used. As it's unlikely that a 
disk will have two programs with 
the same name, this pattern- 
matching format should not pose 
a problem. 



Save Auto Menu on each of 
your disks. When you want to 
use it, load and run it. The au- 
tomated operation sure beats 
typing in loading commands! HI 



Call the Doctor 



This disk uiiUiy has a remedy for just about 
all your disk problems and is a valuable tool for 
regular disk checkups. 



By John Tanzini 
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C-6-l: (',-128 lin C64 model; disk drive 

Oops' You have just scratched, 
Of erased, an important program 
from your disk. Now, what are you 
going to do'? Before you leap out 
that window, call the doctor-Disk 
Doctor, that is. 

Disk Doctor will restore your 
senses by restoring those pro- 
grams or files you've scratched. 
And that's not all. Disk Doctor is 
a disk-utility program with many 
useful functions. 

PROGRAM RESTORATION 

When you run Disk Doctor, the 
following menu will appear on 
the screen. 

select a number 



list directory 
restore a file 
pack directory 
list used blocks 
view or modify block 
format disk 
send disk command 



To select an option from the 
menu, simply press its corre- 
sponding number key. 

Most of you will be interested 
in the ability to restore programs 
that have been scratched. When 
a program is scratched, nothing 
IS actually erased. The directory 
slot is merely reserved until a 
new program is saved. At that 
time, the new program replaces 
the scratched program in the 
directory. 

If many of your programs are 
scratched at one time, it will be 
a whife before they are all written 
over by new programs. Some- 
times a very old program can be 
recovered. 

The first selection in the menu 
is provided to aid you in restor- 
ing programs. The listing will ap- 
pear different from the usual 
directory listing, All items in the 
directory will be displayed, in^ 
eluding scratched files, which will 
be displayed in reverse video. 

If a file no longer remains in 
the directory, it will be impossible 
to leslore. If a file still appears 



(in reverse video) when the di- 
rectory is listed, you may attempt 
to bring it back. 

Even though a program name 
remains in the directory, the 
program itself may have been 
overwritten. There is, however, 
no harm in trying to restore a 
program. You will be informed 
whether or not the attempt was 
successful. 

As the directory ts listed, items 
will scroll off the lop of the 
screen. To freeze the screen, 
press any key. To resume the 
listing, press any key again, 

Press the E key if you wish to 
end the listing, and the menu 
will reappear on the screen. This 
technique for ending an option 
or freezing the screen is the 
same in other parts of this pro- 
gram where items scroll off the 
screen. 

When you want to try restoring 
a program, select number 2 in 
the menu. You will be ast<ed for 
the filename. After you enter it 
and press the return key, a new 
menu will appear: 

Is the file a 

1. program 

2. sequential file 

Program files and sequential 
files are the only types of files 
that can be successfully restored. 
Make the appropriate selection 
and wait for the program to do 
its work. When it is finished, you 



will be given one of three pos- 
sible messages; Cannot Restore, 
Successful Restore or Partial 
Restore. 

It is possible that part of the 
file IS recoverable while the rest 
of the program has been written 
over. Even when the Successful 
Restore message appears, you 
should verify that the file is the 
one you expected. Though very 
rare, it is possible that a new file 
has overwritten the old one and 
then been scratched. Disk Doc- 
tor has no way of knowing that 
it has latched onto the wrong file. 

MODIFY A BLOCK 

A very powerful capability pro- 
vided by Disk Doctor is the ability 
to modify data stored anywhere 
on the disk. That's how this pro- 
gram is able to restore a file 
that's been scratched. The ap- 
propriate bytes in the disk direc- 
tory are modified to indicate that 
the program still exists. 

Of course, if you wish to mod- 
ify the directory, you must un- 
derstand the format and conven- 
tions used by the disk operating 
system. If you do not, you risk 
corrupting the entire disk. 

Don't be afraid to fool around 
with a practice disk, since you 
cannot physically damage the 
disk in any way. Plenty of direc- 
tories were rendered unreadable 
while debugging Disk Doctor. 

You can use Disk Doctor to 



1. LIST DIRECTORY 

2. RESTORE A FILE 

3. PACK DIRECTORV 

4. LIST USED BLOCKS 

5. yiEH OR HODIFV 
SLOCK 

6. FORHAT DISK 

7. SEND DISK COMMAND 



help you learn about the format 
of the directory. It provides you 
with a way to examine the data 
contained on any block. Try se- 
lecting item number 5 (view or 
modify block) from the main 
menu, and you will be presented 
with a new menu: 

1. read block 

2. view block 

3. modify block 

4. write block back 
press E to exit 



Let's read a block from the 
directory. Select item number 1 
(read block). When the screen 
prompts you for the track and 
sector, type in 18,1 and press 
the return key. 

The disk directory is stored en- 
tirely on track 18. Sector is the 
first sector in the directory; how- 
ever, sector 1 is the first sector 
containing filenames. 

A few seconds after reading in 
a block, the menu shown above 
will reappear on the screen. Se- 



lect item number 2 to view the 
contents of the block. 
■ Since the screen is not large 
enough to display the entire 
block at once, only the first 64 
of the 256 bytes in a block will 
appear. The bytes are numbered 
from to 255. This number is 
shown in the left-hand column. 

The next four columns are 
data from the block, shown in 
decimal. The four columns after 
that are the ASCII characters rep- 
resented by the data. 

If you have any programs 
stored on the disk, you will see 
their names on the screen. To 
view the next 64 elements, sim- 
ply press any key. As usual, 
pressing E will end the display 
and return you to the menu from 
which you came, 

If you feel daring, try changing 
one of the letters in a program 
name stored on this block. View 
the block again and note the lo- 
cation of the letter you want to 
change. Return to the menu and 
select item number 3. 

You will be prompted for the 
location of the byte and the data 
you would tike to put into that 
location. The location is the num- 
ber from to 255, shown in the 
first column when the block is 
viewed; it is not the track or sec- 
tor. You are always modifying the 
track and sector that you last 
read in. 

For example, enter 5 as the 



location and 65 as the data. The 
5 is the location of the first letter 
of the first filename in the direc- 
tory, and 65 is the ASCII code 
for the letter A. 

You'll continue to be prompted 
for another location and data, so 
that you may change as many 
bytes as you wish. To return to 
the menu, simply press the re- 
turn key without entering any 
numbers. 

If you view the block again, 
the first letter of the first filename 
will be A. But you haven't yet 
changed the disk. You may view 
and modify the block as many 
times as you like until you are 
sure that you have it just the way 
you want it. When you are ready 
to update ttie disk, select option 
number 4. 

When you attempt to write a 
block back to the disk, you will be 
asked for the track and sector of 
the block. Notice, though, that the 
track and sector of the last block 
read m already appear under the 
cursor. If you want to write back to 
the same block, then simply press 
the return key. If, instead, you wish 
to write back to a different block, 
overstrike the old track and sector 
with the new numbers and press 
the return key. 

You will be asked one final 
question before the block is writ- 
ten back to the disk— "Are you 
sure? (Y/N)." This gives you a 
way out if you selected option 



number 4 by mistake. Pressing 
Y will result in permanently 
changing the disk. Any ottier key 
will return you to the menu. 



AND THERE'S MORE 

You have probably noticed that 
each program you save on a 
new disk appears at the end of 
the directory. After you scratch 
a number of programs, however, 
successive program entries are no 
longer placed at the end. Rather, 
they replace scratched files, thus 
acquiring random locations. This 
makes it difficult to find the latest 
version of a program. 

Selecting item 3 in the main 
menu will compress the direc- 
tory, ftlling in any holes left by 
scratched programs. From then 
on, programs will be added to 
the end of the directory. {This, 
however, lessens the chances of 
being able to restore a scratched 
program.} 

Selecting option number 4 in 
the main menu will list the track 
and sector of all used blocks on 
the disk. It does this by examining 
the block allocation map (BAM) 
stored on track 18, sector 0. 

As files are stored on a disk, 
the disk operating system keeps 
track of which blocks it uses by 
marking those blocks in the 
BAM, One simple way of copy- 
protecting a disk is to store some 
iniodnation on a specific block 



and then to alter the BAM by 
freeing the block. Since the block 
appears to be unused, most 
disk-copying programs will not 
copy that block. 

If you would like to experiment 
with this, try sending a Block Al- 
locate command or a Block Free 
command. Option number 7 in 
the main menu is provided as a 
convenience, so thai you can 
send disk commands without 
having to exit the program. You 
need only type in the actual com- 
mand. All necessary files are 
opened and closed for you. 

For example, to send a Block 
Allocate command that will allo- 
cate track 1 , sector 2, first select 
the Send Disk command option. 
The proper format for the Block 
Allocate command Is: 

B-A:0,1,2 

The format for the corresponding 
Block Free command is: 

B-F:0,1,2 

Files can be scratched using 
the Send Disk command option. 
To scratch a program named 
Disk Doctor, you would send the 
following command: 

S:DISK DOCTOR 
Any valid disk command can be 
sent in this way, but remember 
that Save and Load are not disk 
commands, but Basic commands. 
Option number 6 is a simple 
subroutine, again provided for 



ALL NUMBERS BECIMRL 



1. RERD BLOCK 
2- VIEW BLOCK 



3. MOniFV BLOCK 



4. WRITE BLOCK BACK 



PRESS E TO EXIT 



convenience. It is used to format 
a disk. Since ttie New command 
is used infrequently, most people 
forget the exact syntax and must 
consult the disk manual. Disk 
Doctor will send the command 
for you. merely asking you for 
the disk name and ID. 



FINAL WORDS 

Disk Doctor is a fairly easy pro- 
gram to use. It may seem as 
though there's a lot to remem- 



ber, but the program prompts 
you for any information that it 
needs. 

Usually, when an option is se- 
lected, the program will open a 
disk file, then close the file when 
you return to the main menu. 
Since you should not change 
disks without closing all the files, 
I suggest you only change disks 
when in the main menu. 

Extensive error checking is 
performed by reading the disk- 
error channel each time a disk 



operation is performed. Disk 
Doctor automatically prints out a 
message informing you of the er- 
ror, should one occur. Reading 
the error channel clears the error 
so that you may proceed without 
exiting the program. 

I am certain that you will find 
Disk Doctor a valuable addition 
to your utility programs. Even if 
you never need any of these 
functions to doctor your disks, 
you can use this program to 
(earn how data is kept track of 
and stored on the disk, la] 



10 



The Key to Your 
Disk Directory 

With this handy utility, accessing your disk 
directory is only a function key away, even luhile 
your program is running. 



By Robin Franzel 



RUN It Right 



C-64; C-128 (in C-6-1 mode); disk drive 

Have you ever been running 
a database program and forgot- 
ten a filename when prompted 
for it? You probably had to per- 
form a number of inconvenient 
procedures {such as interrupting 
your program to enter "@$") in 
order to determine the filename. 
The accompanying machine lan- 
guage Disk Directory program 
enables you to display the disk 
directory simply by pressing a 
function key. even while your 
program is running. 

When you press the f3 ke,., 
the directory will appear on the 
screen in two columns. To return 
to your previous display, press 



any key. This will work even 
when you are executing a Basic 
or machine language program. 

Pressing the run/stop and re- 
store keys will disable the direc- 
tory utility; to re-enable it, simply 
enter SYS 49408. 

If you want to list the directory 
using a key other than f3, just 
Poke in the appropriate key code 
for location 197. For example, to 
make the f7 key iist the directory, 
enter POKE 49444,3. 

I wanted a program that would 
use little memory, execute quickly 
and reside in memory with both 
the DOS wedge and the Screen 
Dump utility. (See "Print Your 
Screen," RUN, December 1984.) 
This program meets all those 
standards. It works with any pro- 
gram except those that use the 
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COMHODORE S4 DISK DIRECTORV 
SV R0SIN fftmilL 
PRESS F3 FOR DIRECTORV 



same memory space, which is 
$C100 to $C3DA (49408 to 
50138). 

It will even work with machine 
language monitors resident! (No 
more Formula-loo-complex er- 
rors,) The program does not re- 
quire any dedicated memory 
area outside the boundaries of 
the program itself, because all 



zero-page locations are saved 
and then restored at the end of 
the directory listing. 

I keep the Disk Directory pro- 
gram in my computer just about 
all the time it's turned on! The 
more you use this program, the 
more you'll wonder how you 
ever managed without it. Have 
fun! HI 
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C-64 Big Letters 

Here are three utility programs that let you type 

onto your screen 48 colorful letters, numbers and other 

symbols, four times their normal size. 

By Jimmie W. Bernard 



RUN It Right 



(M C-PJ iin (M miiikl 

Big Letters lets you design 
your own big-letter screen right 
from the keyboard, with nearly 
complete editor functions and 
the capability to mix standard- 
size characters with big ones. If 
you have a VCR, ttnis is an ex- 
cellent way to create your own 
titles one page at a time. 

Using a machine language 
subroutine to expand tfie normal 
character data, the program ac- 
tually composes each giant letter 
of four reconfigured standard 
cinaracters Poked together. In 
Big Letters and Title Maker, you 
may use the first 64 standard 
characters along with 48 big 
characters— A through Z, num- 
bers 1-9, plus # $ % & ' + - 
, . "? ' and the heart character. 
You can use the letter to rep- 
resent a 0, and the remaining 
character is the space, which is 



needed to print a blank or to 
overprint or erase an error. 

Most of the instructions can be 
found on the title page. There 
are 12 screen iines in the pro- 
gram, with a possible 20 char- 
acters on each line. Unfor- 
tunately, there is no cursor, so 
you will have to pay attention. 
But the home/clear key, the cur- 
sor keys and the space bar all 
operate normally, with one ex- 
ception: cursor up or cursor 
down will get you to the begin- 
ning of the line you move to. 

The delete/insert key does not 
function, and the cursor-left key 
will only move you left to the 
beginning of the line you are on. 
Print, border and background 
colors can be changed instantly 
by tapping the left-arrow, up-ar- 
row or pound keys, respectively. 

Title Maker is similar to the 
first program, except, rather than 
being operated from the key- 
board, it is completely prepro- 
grammed through data entries 
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derived from the ASCII appen- 
dix, including the editor and 
color-ctianging functions. 

For example, ttie program 
contains a test message that 
uses big letters, small letters, ed- 
itor controls and color ctnanges. 
Since the program scrolls, there 
is virtually no limit to the length 
of the titles you can make. 

If you look at the portion of the 
listing beginning with data fine 
710, you can see what will hap- 
pen by looking at the data in 
terms of ASCII. The 17s are cur- 
sor downs, so the video title 
presentation begins with a scroll 
from the bottom of the screen; 



the 32s are spaces to center text 
on a line. Then comes the text 
ASCII: 61 is a built-in, one-and- 
a-half-second timer delay you 
can use anytime and as often as 
you wish; 92, 94 and 95 are the 
color changers^the color is 
bumped up by 1 each time. 

In line 760, the number 200 is 
a code by which the program 
does a Gosub to line 1000, 
which adjusts the actual cursor 
to the desired location and then 
prints a message in regular small 
letters. You will have to work at 
getting the small letters exactly 
where you want them. 

Finally, use code 255 as the 



14 



last data entry and there will be 
no Out-of-Data message. Just hit 
the shift key when you have fin- 
ished videotaping your creation. 
The third program, Banner 
Maker, is a little different. You 
can use all 64 characters, up to 
3200 of them, to create a self- 
repeating big-letter banner right 
in the middle of the screen. As 
the program begins, you enter 
your message in regular two-line 
segments, up to 40 inputs. You 
can't Insert colons or commas 
into your sentences. 



Then, when you press the shift 
key, your message will stream 
from right to left at a very read- 
able speed, in big orange letters 
against a black background. 
(Other colors produce flaws or 
flashes in the scrolling chip!} 

You could use the program to 
leave an attention-getting mes- 
sage for someone else right on 
your monitor or TV screen. You 
could also make a terrific window 
display for a business or social 
function, el 
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High-Performance 
Turtle 



Slow and steady will win the race every time. 
Just type in this Basic program to add nine new 
commands for using high-resolution turtle 
graphics on your C-64 or C-128. 

By Richard Holleran 



RUN It Right 



064: G12S lin CM imln 

Turtle Graphics adds ten new 
graphics commands to Basic. 
You can use these commands in 
a program as easily as any other 
Basic command. Turtle Demo 
will give you an idea of how to 
use them in your own programs. 
The routines are written in ma- 
chine language and do, indeed, 
execute quickly. 

THE COMMANDS 

A short explanation of each 
new keyword follows. For fuller 
illustrations of their use. see the 
Turtle Demo program. 



RESET IS the initialization com- 
mand; it centers the imaginary 
turtle on the hi-res screen and 
clears and turns on the hi-res 
screen. 

HIRES allows you to switch di- 
rectly to the hi-res screen without 
clearing it or repositioning the 
turtle. 

TEXT switches you from the 
hi-res to the text (normal) screen. 

COLR allows you to select the 
hi-res colors. For example, COLR 
0,6 sets the screen to black (0) 
and the turtle lines to blue (6). 
The numbers of the colors are 
the same as those found in the 
C-64 owner's manual, {It's unfor- 
tunate that this command cannot 
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be spelled COLOR, but the 
embedded OR keyword pre- 
vents it.) 

LEFT X alters the turtle's 
heading in the counterclockwise 
direction. X is any number or nu- 
meric expression and is mea- 
sured in degrees. 

RIGHT X alters the turtle's 
heading in the clockwise direc- 
tion. X is any number or numeric 
expression and is measured in 
degrees. 



MOVE X is the command that 
propels the turtle, causing it to 
draw a line on the screen. X is 
any number or numeric expres- 
sion. However, it X is negative, 
no move will take place. 

TAILUP causes the turtle to lift 
its tail, allowing it to move without 
drawing. 

TAILDOWN sets the turtle's 
tail down so that it will leave a 
line when it's moved. The tail is 
always set down by RESET. 
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PLOT plots any specified X,V 
point on the tii-res screen. X val- 
ues are limited to ttie range 0- 
319, Y values to 0-199. 

It ttie turtle's travel takes it off 
the screen, no hiarm is done. The 
point or line is simply not Poked 
into memory. However, in the 



case of the PLOT command, a 
Y value greater than 255 will 
cause an Out Of Range error. 

I hope you have fun with this 
program, if at any point you find 
the computer rejecting the turtle 
commands, POKE 1,54 should 
correct the problem. H 
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A Dozen Will Do It 

The C-64's eight function keys can become 12 by 
means of some programming magic. 

By Ronald Greenberg 
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C-64: G128 (i« C-()4 nmk) 

With a little creative program- 
ming, you can turn your C-64's 
eight function keys into 12. This ar- 
ticle shows you how to find those 
four extra function keys and how 
to apply them for Basic and ma- 
chine language programming. 

Through the use of the hard- 
ware interrupt and a machine 
language subroutine, these 12 
keys can function in the back- 
ground as part of the operating 
system even while a Basic pro- 
gram IS running. 

The Commodore function keys 
are typically used in Baste in re- 
sponse to a statement such as: 

GET A$: IF A$ = "F1" THEN 
action 

The "action" can be a Goto 
command, a Print statement, a 
mathematical expression or other 
command. The expression 



above can also be written using 
a numerical representation for a 
character rather than a character 
name. For example: 
GET A$: IF A$ = CHR$(133) 
THEN action 

The expression CHR$(133) is the 
computer's numerical represen- 
tation of f1. The CHR$ values of 
all eight function keys are given 
on page 1 36 of the Commodore 
64 User's Guide. 

FOUR MORE 
FUNCTION KEYS 

The eight C-64 function keys 
are actually four physical keys, 
shifted or unshifted. For exam- 
ple, shifting the f1 key gives f2, 
which has a different GHR$ 
value. To gain access to four ex- 
tra function keys, you use the 
Commodore key as a second 
type of shift key. However, this 
cannot be done in a straightfor- 
ward manner, since shift f1 and 
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Commodore f1 both give the 
same CHR$ value. 

To differentiate between shift f1 
and Commodore f1 within a pro- 
gram, you must examine how 
the computer handles input data 
from the keyboard. Whenever a 
key IS pressed, memory location 
1 97 ($00C5) registers a key num- 
ber. This number is different from 
the CHRS value, as it represents 
a keyboard key rather than a 
character or function. 

The computer generates a 
CHRS value by coupling the key 
number with the value of mem- 
ory location 653 ($028D), which 
is the shift flag. This location 
shows a value of if no shift- 
type keys are pressed, 1 if the 
shift key is pressed, 2 if the Com- 
modore key is pressed and 4 if 
the control key is pressed. 

While the computer cannot 
generate different CHRS values 
for shift f1 and Commodore f1, 
you can differentiate between the 
two by examining memory lo- 
cations 197 and 653. 

The logic that expands the 
number of function keys then 
becomes: 

GET A$ 

IF PEEK(197)=4 AND 

PEEK(653) = THEN action 1 
IF PEEK(197) = 4 AND 

PEEK(653) = 1 THEN action 2 
IF PEEK{197} = 4 AND 

PEEK(653) = 2 THEN action 3 



In this example, hitting f1 will 
result in action 1 , hitting shift f1 
(f2) will result in action 2 and 
hitting Commodore f1 (f1 ') pro- 
duces action 3. This logic can 
extend to the other function keys 
if you use values of 5, 6 and 3 
in memory location 197 for f3, f5 
and f7, respectively. 

This results in a total of 12 
user-defined function keys. One 
interesting point is that, in this 
type of logic, the control key can- 
not be used to try and pick up 
an additional four function keys. 

FUNCTION KEYS AT WORK 

Function Keys demonstrates 
the various methods of access- 
ing function keys in Basic, In this 
program, the function keys are 
used twice— first for setting up 
the screen colors and then for 
providing the choices of mathe- 
matical calculations. 

Additionally, two techniques 
are used for highlighting the func- 
tion key menus on the screen: Ex- 
tended Color mode and reverse 
printing. Highlighting a menu 
makes for a neater-looking dis- 
play as well as making the pro- 
gram easier to use. 

Calculator is a Basic loader for 
a machine language program that 
utilizes the function keys in the 
background. This program de- 
fines eight function keys, while 
leaving the four unshifted keys 
available for Basic programiming. 
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The actions resulting from press- 
ing the function i<;eys are as 
follows: 

Commodore f1 sets the screen 
colors to the Commodore blue. 
Shift f1 sets the screen to black 
on grey, which is much easier to 
see than blue on blue. 
Commodore f3 cycles through 
the background colors without 
having to Poke any values into 
memory. 

Shift f3 cycles through border 
colors. 

Commodore f5 cycles through 
cursor colors. 



Shift f5 loads the disk directory 
if the wedge is being used. 
Commodore f7 lists your present 
Basic program. 
Shift f7 runs your Basic program. 



When you are cycling through 
the colors, you can continuously 
hold down the function key until 
the desired color is obtained. 
This program will keep running 
in the background until you hit 
the run/stop and restore keys. To 
resume this program, just type 
SYS 49152 (return). ID 
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Test Maker 

Here's a chance to make your own tests. You can 
quiz yourself or your friends on any topic, and the 
number of questions you ash is limited only by 
your computer^ memory. 

By Thomas Bunker 
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This program works as a sort 
of sophisticated electronic flash 
card, with the computer showing 
your questions, repeating the 
ones you get wrong and keeping 
score. 

The program has two sec- 
tions—Test Maker, to assist you 
in writing a question-and-answer 
file, and Test Taker, which uses 
these files to test your knowledge 
of a subject. 

After you have created and 
saved your file of test questions 
and answers, using Test Maker, 
load and run Test Taker. When 
It has loaded your file, the ques- 
tions will be printed on the 
screen one at a time. To deter- 
mine if the responses to the 
questions are correct or incor- 
rect, the computer compares the 



answer input from the keyboard 
with the correct answer in the file. 

Test Taker has two modes of 
operation: Test and Drill. In the 
Test mode, the questions are 
presented once, in the same or- 
der in which they were written, 
with the computer showing a 
running total of right or wrong 
responses and a summary of re- 
sults upon completion of the test. 

In the Drill mode, the questions 
are randomly selected from a 
pool that initially contains all the 
questions m the file. A correct 
answer removes a question from 
the pool while an incorrect an- 
swer leaves the question to reap- 
pear until it IS answered cor- 
rectly. You must answer all the 
questions correctly to finish the 
drill. 

In either mode, if you answer 
incorrectly, the computer re- 
trieves the correct answer from 
the file and prints it on the 
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screen. The Drill mode allows 
you two attempts to answer a 
question eachi lime it appears, 
but only thie first attempt counts. 
Pressing the return key without 
entering anything will immedi- 
ately print the correct answer. 

Load and run Test Maker first, 
as you cannot check out the 
main program without first writing 
a question file, Since the file is 
empty, the menu jvill only offer 
two selections: Load and Write. 
Press W for the latter, and the 
computer will prompt you to en- 
ter question #1. (If you are not 
starting a new file, the number 
will be the next available position 
in the file.) 

Enter your question and place 
a question mark at its end. 
Space it properly. Press Itie re- 
turn key and enter what you 
want the computer to recognize 
as a correct answer. Be careful 
to use either upper- or lower- 
case, not both, unless you tell 
your student to use both. 

When you are through enter- 
ing questions, respond to the 
question prompt by typing in the 
word menu by itself (the com- 
puter interprets this as a com- 
mand and will not enter it in the 
file). The file is no longer empty, 
so the menu should now show 
a list of four options: Write, Load, 
Edit and Save. 

The Edit mode will print any 
question and answer set you se- 
lect and offer four options: Next, 



which will print the next question 
in the file; Change, which lets 
you write a revised question that 
will replace the question shown 
on the screen; Drop, which will 
delete the question shown and 
shift all higher numbered ques- 
tions in the file down to close the 
gap; and fvlenu, which will return 
you to the menu. 

You can edit or save a file at any 
time and return to the Write mode 
without losing your place. The 
computer will always show the 
next available spot in the file when- 
ever you enter the Write mode. 

Tape operations are handled by 
selecting Load or Save from the 
menu. When directed by screen 
prompts, position the cassette 
tape to the place where you want 
to load or save. If there is a file in 
memory, the Load command will 
give you the option of either add- 
ing to or replacing this file. 

This lets you combine a num- 
ber of small files into one long 
file, but you must be careful, as 
this IS one of the few places 
where the program cannot pro- 
tect you from mistakes. If you do 
not have sufficient memory or if 
the total number of questions ex- 
ceeds the size of the array, the 
program will crash. This is not a 
serious problem. Just make sure 
that you have saved the files 
separately before attempting to 
merge them. 

It is very discouraging to 
spend an hour typing in a long 
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series of questions only to see 
an Out of Memory message and 
realize that all your work is gone 
forever. The program protects 
against ttiis and other potential 
disasters, including many caused 
by operator errors, by checking 
the amount of memory remaining 
after every question is written to 
the file. 

If less than 300 bytes remain, 
the actual number will be printed 
on the screen. This is a caution- 
ary message only; you can con- 
tinue entering questions and 
nothing will prevent you from 
going right off the end. so watch 



the memory remaining and save 
before you get too close to 0. 

If the number of items in the file 
reaches the limit for which the ar- 
ray IS dimensioned, a File Full 
message will appear. You can still 
edit and save, but you will not be 
able to enter the Write mode. 

All the commands that can af- 
fect a file require your confirmation 
before execution. Pressing Y (for 
yes) will cause the operation to 
proceed, while pressing N (or 
any other key) will aborf the 
operation. 

Load and run Test Taker and 
enter a file tape (previously writ- 
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ten and saved using the File 
Editor} as indicated by screen 
prompts. A menu will let you 
ctioose either type of test or load 
a new program. In either Test or 
Drill mode, the number ol the 
question currently on the screen 
will be displayed in the upper 
left-hand comer. You can quit ei- 
ther test before finishing and 
jump back to the menu by en- 
tenng the pound sign (£} in re- 
sponse to a question. 

QUESTION GUIDELINES 

The standard Commodore In- 
put statement was used m the 



question file. This means that you 
cannot use commas, colons and 
cursor movements, but you may 
use periods, semicolons or quo- 
tation marks. 

When you are ready to enter 
a question, the cursor will be 
flasfiing at the extreme left side 
of the screen; this allows you to 
enter four screen lines on the VIC 
or two screen lines on the 64. 
When you run Test Taker, ques- 
tions will appear exactly as you 
type them into Test fvlaker so you 
must format your entry to avoid 
leaving part of a word at the end 
of a line. If you are m doubt, 
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write a question and jump to the 
Edit mode to see what has ac- 
tually been recorded in the file. 

When writing your answers, re- 
member that the computer re- 
quires an exact match to indicate 
a correct response, it will even 
make a distinction between a cap- 
ital letter and a lowercase letter. 

If the correct answer can only 
take one form— for example, if 
it's a year or a city— then that 
answer should be entered com- 
pletely. However, if an answer 
could be stated in various ways, 
you might want to design a mul- 
tiple-choice question, using a let- 
ter to indicate the proper answer. 

It might be helpful to under- 
stand how the computer decides 
whether or not it has received a 
correct response. The number of 
letters in a file answer is the num- 
ber of letters the computer looks 
at in the response. 

For example, it you want the 
correct response to be California, 



and you are using iowercase let- 
ters, you might designate "ca" 
as an answer when writing the 
file. The computer would accept 
as correct ca, calif, California or 
any word irt which the first two 
letters were ' ca." 

When \ ju are entering your 
questions t.nd answers in the 
Test Maker program, if you type 
the pound sign {£) immediate- 
ly after the acceptable answer 
(don't leave a space), the com- 
puter will ignore the remainder 
of the entry when evaluating the 
response from: the main pro- 
gram. You can also use the 
pound sign to further elaborate 
upon the answer or add a hu- 
morous remark that might be ap- 
propriate after a person has 
entered an incorrect response. 

The number of questions you 
can write depends on the size of 
your computer's memory and 
the length of the questions. \E 
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Home Run Derby 

Koufax vs. Clemente, Seaver vs. Rose, Drysdale 
vs. Mays, Gossage vs. Ria'. Experience the thrill and 
excitement of these classic pitcher/batter confrontations 
with this top-quality program. 

By Mark Jordan 
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One or two joysticks 

Home Run Derby is a fun com- 
puter baseball game with two 
twists. One. instead of a regular 
baseball contest, it's just you 
against the pitcher, and— 
crack! — you're going for the 
fence. You can play against the 
computer or another person. The 
other twist is that the game is 
played at night. 

Once Home Run Derby loads, 
you'll be transported to a color- 
ful, lighted stadium packed with 
enthusiastic fans. The lights are 
so bright you can see the ball's 
shadow follow the ball as it 
heads for the fence. 

The concept is simple. In each 
of the nine innings, you and your 
opponent get a certain number 
of pitches; you try to hit as many 



balls over the fence as you can. 
If you play alone, you can hit for 
both sides. To swing, you simply 
press the fire-button (joystick in 
port 2). You have the option of 
allowing the computer to do all 
the pitching, or you and your 
opponent, depending on who's 
pitching, may control the type of 
pitch thrown. 

If you opt for player-controlled 
pitching, you'll need to plug a 
second joystick into port 1. De- 
pending on joystick positions, 
you have nine pitches available 
(see Table 1). 

To release your pitch, just 
point the joystick in the proper 
direction and press the button. 
By mixing up the pitches, the 
defensive player can effectively 
prevent the batter from getting 
into a "groove." If the computer 
is controlling the pitching, it will 
do the mixing automatically. 

Hitting the ball over the wall may 
seem hard at first, but be patient; 
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by the end of one nine-inning 
game, you'll have the knack- 
somewhat. The computer looks 
for perfect timing, If you swing 
when the ball is within nine pixels 
of your strike zone (dead center of 
batter's body), you'll hit it some- 
where. Of course, the closer to 
dead center, the farther the ball 
will carry. Anotlier factor in the 
ball's carry is the speed of the 
pitch; just as in real baseball, a 
blazing fastball is easier to put 
into the seats than a change-up. 
(That also ought to keep Goose 
Gossage-style pitchers from 
throwing nothing but heat.) 

The risers and sinkers are 
dandy pitches because, if they are 
out of the strike zone, they will re- 



sult in nothing better than a sharp 
foul tip. However, some don't sink 
or rise quite out of the strike zone, 
and these can easily be hit. Not 
only that, but if the batter lays off 
the ones that look too high or too 
low, an automatic umpire will call 
balls and strikes. If the pitch was a 
ball, then it doesn't count against 
the batter. So, it you can just lay 
off those forkballs, sliders, knuck- 
lers and rising fastballs, you won't 
lose any of your nine pitches. That, 
of course, is easier said than done. 
The rest ot the game is com- 
pletely self-explanatory, even if 
you know nothing about base- 
ball, A complete game takes 
about five minutes, unless you 
go extra innings. 



29 



The game makes use of many 
of the 64 's excellent sound and 
graphiics features, including two- 
part liarmony, sound effects, an- 
imated sprites and a smoothly 
arcing batted ball with its 
shadow. I used an interrupt rou- 
tine to create a stylized crowd 
that seems to be quite involved 
in the ball game. All the action 
is controlled via machine lan- 
guage, so the game plays 
smoothly. 

So, enjoy a nice summer eve- 
ning under the lights playing 
Home Run Derby. There's a long 
drive! It's going, going... H 



t,EFT— siniiHhi lastbiill 
LKFIVCl*— i-isiiiK faslliull 
I.KFTrt>()\VN— .siiikiiis,' f;isih;ill 
RIGUl— sti;ii|,'ln .sl()wl);il! 
RH;I II;LP— rising sluwb.ill 
RIGHT/DOWN— sinking slowball 
UP — medium ri.scr 
DOWN — iiiL'iliuni sinker 
NO DIRtCl K)N (rireliuit.in)— 
medium straight ball 

Table 1. Pitches available to you in 
Home Run Derby, according to joystick 
positions. 
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Gold Grabber 

Bags of gold are dropping from the sky, and 

you've got to be quick to catch and bury them in this 

nine-level game of fun and strategy. 

By Pasquale Longo 
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Joystick 

In Flynn's Gold, Flynn is a dar- 
ing adventurer, He hides behind 
a hill watching bags of gold fall- 
ing down from the sky. An ea- 
gle soars, swoops and glides 
overhead. 

Flynn must run ou(, catch the 
gold, bring it back to the hill and 
bury it. 

This is a dangerous task. Giant 
ten-ton weights rain down on 
Flynn every time he leaves the 
safety of the hill. If the eagle is 
hungry, he might attack him. 

Guide Flynn with a joystick 
plugged into port 2. To catch a 
bag of gold, position Flynn under 
it. Bury the gold by guiding Flynn 
back to the hill and pressing the 
fire-button. 

You receive points for each 
bag of gold caught. You also 
receive points when you bury the 



gold. The bags of gold vary in 
point value, with those greatest 
in value falling farthest to the left. 
Burying a bag gives you addi- 
tional points, 

Flynn can only carry and bury 
one bag of gold at a time— the 
last one caught. Therefore, when 
you are running to bury a more 
valuable bag of gold, you must 
be careful not to catch a bag of 
lesser value, as this bag will re- 
place the one you were holding. 
You'll retain all the points you 
earned for having caught the 
more valuable bag, but because 
you lost the bag before burying 
it, you won't earn as many points 
upon burial. 

The game ends when you 
have caught and buried 25 bags 
of gold. 

To play the game, you're 
given three Flynns. The game 
ends when you lose ail of them. 

There are nine levels of play. 
You can select the level of diffi- 
culty at the beginning of a game 
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(when the game is waiting for 
you to press f1) by pressing 13. 
The higher the level, the more 
points you receive for catching 
a bag of gold and for burying it. 
If you get off to a bad start, 



you can restart the game by 
pressing the stop key. To quit 
the game entirely, press the re- 
store key. 

The program takes about three 
minutes to load. IB] 
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Byte-Size Compiler 

Don 'I let your Basic programs slow you down. This 
short little compiler adds unhelievable execution speed 
to your programs, and it 's easy to use. 

By Victor H. Cortes 
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Micro Compiler is an integer 
Basic compiler for the Commo- 
dore 64. A compiler converts a 
high-level language program, 
such as one written in Basic, into 
a machine language program. It 
allows you to take advantage of 
machine language speeds with- 
out knowing machine language. 

Micro Compiler compiles a sub- 
set of the regular Commodore Ba- 
sic, which I call fvlicro Baste, into 
machine language. Since it is a 
subset of the regular Commodore 
Basic, you can develop, test and 
save programs using the regular 
Basic interpreter. 

To begin, load and run Micro 
Compiler. When the compiler is 
run. It first asks for the name of 
the fvlicro Basic program, or 
source program, to be compiled. 
Then it asks for the address at 
which to start placing the ma- 



chine language, or object, code. 
If no address is entered, the 
compiler defaults to 49152. The 
source program is then read di- 
rectly from disk and is listed line 
by line. 

A special technique is used to 
convert the command tokens on 
disk to their expanded form and 
to print them. If any errors are 
encountered, a message is 
printed under the line in ques- 
tion. Since it is assumed that the 
source was tested with the reg- 
ular Basic interpreter, a minimum 
of error checking is done. If an 
error is found, it is usually be- 
cause of an invalid Micro Basic 
command. Once the program is 
compiled, you have the option of 
saving the code, executing the 
code, compiling another pro- 
gram or just terminating. 

When saving the machine lan- 
guage code, the compiler will 
ask for the name of it. If no name 
is entered, the compiler defaults 
to the source name plus ".ML". 
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After the compiled code is 
saved, you can load it with a 
regular Basic program, using the 
statement; LOAD "program 
name".8,1. The code can be ex- 
ecuted from Basic with the SYS 
command to the starting address 
of the code (usually SYS 49152). 
This can be done in Direct mode 
or in Program Run mode. 

Since a full Basic compiler would 
be a very large program, this com- 
piler was written to handle a subset 
of Basic. This subset has a number 
of limitations. No nesting of If or For 
statements is allowed/ and string 
variables and variable arrays are 
not supported. 

There are, however, many 
ways to get around these limi- 
tations. For example, instead of 
using a variable array to hold 
numeric values, you can Poke 
these numbers into an area in 
memory. You can accomplish 
essentially the same task by 
changing 

FOR l = 1T05: A(l) = l: NEXT 
to 

FOR l = 1T05: POKE 828 -t- 1,1: 
NEXT 

Usually, you'll just compile a 
Basic subroutine that needs 
speeding up. Then, instead of 
performing the subroutine with a 
Gosub statement, you can call 
the compiled routine with a SYS 
statement. You can also write 



and compile for execution a pro- 
gram written only with Micro Ba- 
sic statements. 

The following is a list of the 
Micro Basic commands the com- 
piler can process: 

{LET} V = Expr 
PRINT {Expr} {CHR$ 

(Expr)} {■■stnng-} {:} 
IF Expr Cmpr Expr THEN 

{statements or !ine#} 
FOR V = Expr TO Expr 

{STEP Expr} 
NEXT 

POKE Expr, Expr 
SYS Expr 
GOTO N 
GOSUB N 
RETURN 
END or STOP 
REM {remarks} 

{} indicate an optional item. 

V is used to represent a vari- 
able name. The first character in 
the name must be unique (A-Z}. 
These variables use memory lo- 
cations 680 to 731 . 

N is used to represent a nu- 
meric integer literal. Its value can 
be from to 65535. 

X is used to represent a vari- 
able or a numeric integer {V 
or N). 

Expr is a numeric expression 
beginning with X or PEEK(X) and 
optionally followed by any num- 
ber of the following: {+ X}{- 
X}{* X}{/X}{ANDX]{ORX}. 

Cmpr IS a type of comparison 
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and can be one of the following: 
= (equals), > (greater ttian), 
< > (not equal to) or < (less 
than). 

The following are examples of 
valid statements: 

R = PEEK(A} * ^00 I M 
IF Y*40 + X > 2023 THEN 

PRINT CHR$(147); 
FOR I = 1 TO X + A : 

PRINT I + 64 : NEXT 
SYS B+1024 : RETURN 
GOSUB 500 ; PRINT ■TOTAL";T 
GOTO 20 
POKE A-i. J AND 15 : END 



The following are examples of 

invalid statements: 

R = COS(B) 

PRINT Tl$ 

GET X$(l) 

OPEN 15.8,15 

Like regular Basic, the "LET" 
is optional in the Let command. 
It is used to assign an expression 
to a variable. An expression must 
begin with a vahable, a number 
or the Peek function of a variable 
or number. It can be followed by 
other vanables or numbers, as 
long as they are separated by 
+ , "-, *, /, AND or OR. 
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The expression is evaluated 
from left to right, with no operator 
precedence and no parentheses. 
Because of this, you must place 
the multiplication and division op- 
erators first, the addition and 
subtraction operators next and 
the and/or operators last. This 
will ensure correct evaluation of 
an expression by the compiled 
program. 

The Print command can be 
used to print a numeric variable, 
a PET ASCII character (CHR$) 
or a string. The optional semi- 
colon, if used, will prevent a 
carriage return after the Print 
statement. The semicolon can 
also be used to print any com- 
bination of these. Only the Print 
command allows literal strings. 

In the If... Then statement. 
Then can be followed by a line 
number or any other f\/licro Basic 
statement. f\/lultiple statements 
can be put on one line as long 
as they're separated by colons. 
However, it's easier to correct er- 
rors if each command is on a 
separate line. 

All the string-manipulation 
commands (LEFTS. IVIIDS,..,) 
are omitted because fvlicro Basic 
does not handle string variables. 
It can only handle numeric inte- 
ger variables or literals in the 
range of to 65535 (two bytes), 

Some commands can be simu- 
lated; for instance, instead of the 
Get command, you can use 
PEEK(197) to read the (keyboard. 



The value returned by the 
PEEK(197) can even be con- 
verted to its PET ASCII equivalent 
by using the internal ROM tables, 
fvlost of these restrictions were 
necessary to keep the compiler 
program to a reasonable size, 

Test Compiler's main function 
is to test whether the compiler is 
working correctly. When you 
load and run it, the program first 
clears the screen and prints 
TEST.COIVIP. It then positions the 
cursor to the tenth line and prints 
TEST. Next, it prints numbers 
from 1 to 5. You should then 
press keys at random. The pro- 
gram reads the keyboard and 
prints the characters that were 
entered. 

It then identifies the character 
as being equal to, greater or less 
than the character A. It also 
changes the screen border to 
green if the character entered is 
equal to an A, and to red if it is 
not. The program will terminate 
when the f7 key is pressed. 

You can then load and run 
Micro Compiler, When prompted 
by the compiler for the source 
name, enter Test Compiler. Press 
the return key when prompted 
for the address to default to 
49152, The test program will 
load and begin compiling. After 
the compilation is done, the com- 
piler will display the address 
range (starting and ending ad- 
dresses) required by the com- 
piled code and also the number 



36 



MICRO COMPILER 

SOURCE NRME? TEST COMPILER 

STfiRTIHG ADDRESS? 49152 

COMPILED 

ERRORS 

ADDRESS RANGE 49152-49159 

SOURCE NAME? TEST COMPILER COMPILED. 

TIME: 000 126 

1-SAVE 2=EXEC 3«C0MP 4=QUIT 



of errors encountered. It will theri 
display the following options: 

1. Save— use to save the ma- 
chine language code. 

2. Execute— will execute the 
machine language code. 

3. Compile— will allow you to 
compile another program. 

4. Quit—will send you back to 
Basic. 

Enter option 2 to execute the 
program. The results should be 
similar, except for the speed of 
the compiled version. 

Colors Demo demonstrates the 
difference in speed between an 



uncompiled versus a compiled 
program. This program fills the 
screen with various color de- 
signs. First, type it in and run it, 
noting how long it takes to fill the 
screen with color patterns. Now 
load and run the compiler. When 
prompted for the source name, 
enter Colors Demo and enter a 
starting address of 49152. When 
the program has been compiled, 
enter option 4 to terminate the 
compiler. 

Now enter SYS 49152 to ex- 
ecute the compiled machine lan- 
guage code. The screen should 
fid instantly, compared to the 
minute or more required for the 
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Basic version. This should con- 
vince you of one of the advan- 
tages of using a compiler pro- 
gram. The compiled versions of 
Basic programs are so fast that 
you will often have to insert a 
For... Next loop to hold a pro- 
gram to controllable speeds. 



With this compiler, you'll be 
able to develop programs using 
a high-level language {a subset 
of Basic) that will give you, as a 
final product, a program in the 
machine's own language, help- 
ing you take advantage of the 
computer's full capabilities. El 
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; Exciting Programs 
From RUN*sJune,Jtdy and August issues! 

Including. . . 
Home Run Derby 
Big Letters' 
Turtle Graphics 
Function Keys 
, Test Maker 
Gold Grabber 
And More! 
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